home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / mint / shells / bashsrc.zoo / readme < prev    next >
Encoding:
Text File  |  1991-05-29  |  2.2 KB  |  64 lines
  1. Hey Emacs, this is a -*- text -*- file.
  2.  
  3. This is the README file for bash, the Bourne Again SHell.  This shell
  4. comes with no documentation at this time.  There is an online help
  5. facility, and a file called FEATURES that comes with the distribution.
  6.  
  7. When the documentation is completely finished, it will be included in
  8. the distribution.  No partial documentation is included because it
  9. causes complaints.
  10.  
  11. INSTALLING:
  12.  
  13. The file "Makefile" no longer needs to be edited.  In fact, to install
  14. Bash, the simplest thing to do is to type "make".  The Bash Makefiles
  15. will try to dynamically figure out what kind of machine and operating
  16. system you are using, and will make an educated guess.  During the make
  17. process a message is displayed describing what machine and OS has been
  18. chosen (this information is also saved in the file ".machine").  If the
  19. displayed information is incorrect, you will have to edit the file
  20. "machines.h".  The instructions for doing so are present in that file.
  21.  
  22. The file called INSTALL gives detailed instructions on installation.
  23. However, for most machines, simply following this simple checklist
  24. is quite adequate:
  25.  
  26.     1) Type `make'.
  27.     2) Wait for the compilation to finish.
  28.     3) Type `./bash' to see if the compile worked.
  29.     4) Type `cp ./bash /usr/gnu/bin/bash' (or wherever you
  30.         keep GNU binaries).
  31.  
  32. BUT WHAT IF IT DOESN'T INSTALL SO EASILY?
  33.  
  34. Read INSTALL.
  35.  
  36. REPORTING BUGS:
  37.  
  38. If you find a bug in bash, you should report it.  But first, you should
  39. make sure that it really is a bug, and that it appears in the latest
  40. version of Bash that you have.
  41.  
  42. Once you have ascertained that a bug really exists, you are welcome to
  43. mail me a bug report.  If you have a fix, you are welcome to mail that
  44. to me as well!  Suggestions and `philosophical' bug reports may be mailed
  45. to bug-bash@ai.mit.edu.  Real bug reports may be mailed to the same
  46. place, or to me, bfox@ai.mit.edu.
  47.  
  48. ALL bug reports should include:
  49.  
  50.     * The version number of Bash
  51.     * The hardware and operating system
  52.     * The compiler used to compile
  53.     * A description of the bug behaviour
  54.     * A short script or `recipe' which exercises the bug
  55.  
  56. Without this information, I generally cannot successfully debug Bash,
  57. because usually, without this information, I generally cannot make the
  58. bug manifest itself!
  59.  
  60. Enjoy,
  61.  
  62.     Brian Fox
  63.  
  64.